КомментарийDOM.ЗаменитьДочерний (DOMComment.ReplaceChild)
КомментарийDOM (DOMComment)
ЗаменитьДочерний (ReplaceChild)
Доступен, начиная с версии 8.1.
Синтаксис:
ЗаменитьДочерний(<НовыйУзел>, <СтарыйУзел>)Параметры:
<НовыйУзел> (обязательный)
Новый дочерний узел.
<СтарыйУзел> (обязательный)
Существующий дочерний узел.
Возвращаемое значение:
Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.Значение прежнего узла.
Описание:
Заменяет дочерний узел, указанный параметром <СтарыйУзел>, на узел, указанный параметром <НовыйУзел>.
Если новый узел - это ФрагментДокумента, то заменяемый узел будет заменен всеми дочерними узлами фрагмента документа.
Если новый узел уже содержится в дереве документа, то он сначала удаляется из дочерних узлов старого родителя и вставляется в список дочерних узлов нового родителя.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Исключение генерируется в случаях:- если данный узел не допускает в качестве дочерних добавляемый узел или добавляемый узел является одним из предков данного;
- если узел добавляется сам в себя;
- если данный узел - Документ и добавляется второй узел ОпределениеТипаДокумента или Элемент;
- если добавляемый узел был создан документом отличным от создавшего данный узел;
- если данный узел в режиме только для чтения или если предыдущий родитель добавляемого узла в режиме Только для чтения;
- если заменяемый узел не найден;
- если добавляемый узел является дочерним узлом узла Документ и реализация не поддерживает удаления узлов ОпределениеТипаДокумента и Элемент у узла Документ.
Использование в версии:
Доступен, начиная с версии 8.1.